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METHOD AND APPARATUS FOR GENERATING A 
SOFTWARE DEVELOPMENT TOOL 

Background of Invention 

[0001] Automatic code generation is becoming increasingly common in the 
software development lifecycle. The need for automatic code generation has 
resulted from the increasing complexity of applications and the acceptance of 
various standard and de facto standard application programming interfaces (APIs). 
For example, Java™ contains many APIs that software developers regard as 
de facto standard. The complexity of these APIs ranges from simple core Java™ 
APIs found in Java™ 2 Standard Edition to complex APIs used for specialized 
applications such as Java™ Media Framework. Automatic code generation tools 
allow developers to efficiently develop and integrate simple and complex APIs 
into new software products. Further, automatic code generation tools automate the 
process of typically tedious and error-prone coding tasks. 

[00021 Automatic code generation tools are typically specialized to produce a 
particular entity, e.g., an Extensible Markup Language (XML) document, an 
Enterprise JavaBean (EJB), etc. For example, Forte™ for Java™ is an integrated 
development environment (IDE) capable of creating Enterprise JavaBeans. 
Forte"^" for Java"^"*^ contains productivity tools such as a graphical user interface, 
various wizards, etc. to aid in the development process. A wizard is an interactive 
help utility within an application that guides the developer through each step of a 
particular task, such as entering properties of a desired EJB. As new APIs are 
developed and/or new capabilities are desired, new specialized automatic code 
generation tools will need to be developed. 
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Summary of Invention 

[0003] In general, in one aspect, the invention relates to a method for generating a 
software development tool, comprising creating a definition file defining an action 
to be performed by the software development tool, creating a schema defining 
characteristics of a plurality of desired inputs for the software development tool, 
creating a resource file comprising information required by the software 
development tool at runtime, and generating the software development tool using 
the definition file, the schema, and the resource file. 

[0004] In general, in one aspect, the invention relates to a method for generating a 
software development tool, including creating a definition file defining an action 
to be performed by the software development tool, creating a schema defining 
characteristics of a plurality of desired inputs for the software development tool, 
creating a resource file comprising information required by the software 
development tool at runtime, creating a command list comprising a set of 
commands that are used to define the action, generating the software development 
tool using the definition file, the schema, and the resource file, and generating an 
annotation defining custom characteristics of a user interface of the software 
development tool using the schema. 

[0005] In general, in one aspect, the invention relates to a method for generating a 
software development tool, comprising creating a definition file defining an action 
to be performed by the software development tool, creating a schema defining 
characteristics of a plurality of desired inputs for the software development tool, 
creating a resource file comprising information required by the software 
development tool at runtime, creating a command list comprising a set of 
commands that are used to define the action, creatmg an annotation defining 
semantics of a graphical user interface of the software development tool, and 
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generating the software development tool using the definition file, the schema, the, 
annotation, and the resource file. 

[0006] In general, in one aspect, the invention relates to a computer-readable 
medium having recorded thereon instructions executable by a processor, the 
instructions for receiving a definition file defining an action to be perfonned by 
the software development tool, receiving a schema defining characteristics of a 
plurality of desired inputs for the software development tool, receiving a resource 
file comprising information required by the software development tool at runtime, 
and generating the software development tool using the definition file, the 
schema, and the resource file. 

[0007] In general, in one aspect, the invention relates to a computer system to 
generate a software development tool, comprising a processor, a memory, an input 
means, a display device, and instructions stored in the memory for enabling the 
computer system under control of the processor, to perform: receiving a definition 
file defining an action to be performed by the software development tool, 
receiving a schema defming characteristics of a plurality of desired inputs for the 
software development tool, receiving a resource file comprising information 
required by the software development tool at runtime, receiving a command list 
comprising a set of commands that are used to define the action, generating the 
software development tool using the definition file, the schema, and the resource 
file, and generating an annotation defining custom characteristics of a user 
interface of the software development tool using the schema. 

[0008] In general, in one aspect, the invention relates to a computer system to 
generate a software development tool, comprising a processor, a memory, an input 
means, a display device, and software instructions stored in the memory for 
enabling the computer system under control of the processor, to perform: receiving 
a defmition file defining an action to be performed by the software development 
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tool, receiving a schema defining characteristics of a plurality of desired inputs for 
the software development tool, receiving a resource file comprising information 
required by the software development tool at runtime, receiving a command list 
comprising a set of commands that are used to define the action, receiving an 
annotation defining semantics of a graphical user interface of the software 
development tool, generating the software development tool using the definition 
file, the schema, the annotation, and the resource file. 

[0009] In general, in one aspect the invention relates to an apparatus for generating 
a software development tool, comprising means for creating a definition file 
defming an action to be performed by the software development tool, means for 
creating a schema defining characteristics of a plurality of desired inputs for the 
software development tool, means for creating a resource file comprising 
information required by the software development tool at runtime, means for 
creating a command list comprising a set of commands that are used to define the 
action, means for generating the software development tool using the definition 
file, the schema, and the resource file, and means for generating an annotation 
defining custom characteristics of a user interface of the software development 
tool using the schema. 

[0010] In general, in one aspect, the invention relates to an apparatus for 
generating a software development tool, comprising means for creating a 
definition file defining an action to be performed by the software development 
tool, means for creating a schema defining characteristics of a plurality of desired 
inputs for the software development tool, means for creating a resource file 
comprising information required by the software development tool at runtime, 
means for creating a command list comprising a set of commands that are used to 
define the action, means for creating an annotation defining semantics of a 
graphical user interface of the software development tool, and means for 
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generating the software development tool using the definition file, the schema, the 
annotation, and the resource file. 

[0011] Other aspects and advantages of the invention will be apparent from the 
following description and the appended claims. 

Brief Description of Drawings 
[0012] Figure 1 illustrates a typical computer. 

[0013] Figure 2 illustrates a flow diagram for a software development tool 
generator in accordance with one embodiment of the invention. 

[0014] Figure 3 illustrates a software development tool generator integrated within 
an Integrated Development Environment in accordance with one embodiment of 
the invention. 

[0015] Figure 4 illustrates a "Choose Name" panel in accordance with one 
embodiment of the invention. 

[0016] Figure 5 illustrates a "Specify Session Property" panel in accordance with 
one embodiment of the invention. 

[0017] Figure 6 illustrates a software development tool integrated within an 
Integrated Development Environment in accordance with one embodiment of the 
invention. 

Detailed Description 

[0018] Exemplary embodiments of the invention will be described with reference 
to the accompanying drawings. Like items in the drawings are shown with the 
same reference numbers. 

[0019] In the following detailed description of the invention, numerous specific 
details are set forth in order to provide a more thorough understanding of the 
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invention. However, it will be apparent to one of ordinary skill in the art that the 
invention may be practiced without these specific details. In other instances, well- 
known features have not been described in detail to avoid obscuring the invention. 

[0020] The present invention relates to a method for generating a specialized 
software development tool. Further, the present invention relates to using a 
definition file, a schema, and a resource file to generate the software development 
tool. Further, the present invention relates to generating a software development 
tool with a user interface. 

[0021] The present invention may be implemented on virtually any type computer 
regardless of the platform being used. For example, as shown in Figure 1, a 
typical computer (10) includes a processor (12), associated memory (14), a storage 
device (16), and numerous other elements and functionalities typical of today's 
computers (not shown). The computer (10) may also include input means, such as 
a keyboard (18) and a mouse (20), and output means, such as a monitor (22). 
Those skilled in the art will appreciate that these input and output means may take 
other forms in an accessible environment. 

[0022] Figure 2 illustrates a flow diagram for a software development tool 
generator in accordance with one embodiment of the invention. The software 
development tool generator (SDTG) (24) takes a definition file (26), a schema 
(28), and a resource file (30) as inputs, and generates a software development tool 

(SDT) (34). 

[0023] The definition file (26) references all required files necessary for building 
the SDT (34). In one embodiment of the invention, the definition file is an XML 
document. Further, the definition file defines actions that the tool may perform. 
In one embodiment, the definition file includes 7 elements: <Name>, <General>, 
<Source>, <Metadata>, < Userlnterface>, <Runtime>, and <Action Definition>. 
The <Name> element contains the name of the tool that the SDTG (24) produces. 
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The <General> element contains information of general relevance such as the 
version of the SDT (34), a short description of the SDT (34), and a long 
description of the SDT (34). 

[0024] The <Source> element contains references to other files that serve as input 
to the SDTG (24), as well as describes general outputs. The <Source> element 
includes a number of sub-elements. The sub-elements may include, but are not 
limited to: a <JavaPackage> sub-element, a <SchemaFile> sub-element, an 
<AnnotationsFile> sub-element, a <ResourceFile> sub-element, and a 
<PropertyFile> sub-element. The <AnnotationsFile> and <ResourceFile> sub- 
elements are optional. The <ResourceFile> sub-element may be included multiple 
times. The <JavaPackage> sub-element identifies the Java^^ package that is to 
contain all the Java™ source code generated for the SDT (34). The <SchemaFile> 
sub-element identifies the file that contains the schema (28). The schema (28) 
describes the input that the SDT (34) collects to generate a desired entity. The 
<AmiotationsFile> sub-element identifies the file that contains the annotations 
(36). The annotations (36) are a formal mechanism allowing the user to declare 
and/or customize the user interface of the SDT (34). In one embodiment, the 
SDTG (24) initially generates the annotations (36) and subsequently provides 
access to them such that the user may customize the user interface of the SDT 
(34). In another embodiment of the invention, the annotations (36) are generated 
by the user and input into the SDTG (34), The <ResourceFile> identifies files 
that are required by the SDT (34) at runtime. The <PropertyFile> sub-element 
includes functionality to support intemationalization, localization, and 
accessibility. In one embodiment of the invention, the user of the SDTG (24) 
provides the <PropertyFile>. In another embodiment of the invention, the SDTG 
(24) generates the <PropertyFile>. 
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[0025] Referring back to the definition file (26), the <Metadata> element identifies 
files that contain metadata default values for input specified in the schema (28). 
Metadata is an internal representation of data collected fi*om the user used by the 
SDTG (24). In one embodiment of the invention, metadata is represented using 
Extensible Mark-up Language (XML). The metadata default values are consistent 
with the schema (28). The <UserInterface> element describes how the SDT's 
(34) functionality is made available within the user interface of the SDT (34). For 
example, the <UserInterface> element may specify that a specific functionality 
may only be accessible through a toolbar. The <Runtime> element describes the 
semantics of the runtime environment. The <ActionDefinition> element describes 
actions that the SDT (34) may perform. If the SDT (34) is to perform multiple 
actions, then each action is defined. The actions are defined in terms of a series of 
pre-defined commands. For example, an action may contain an <Ant> command 
followed by a <Transform> command. Where the <Ant> command processes 
input using an Ant script, the result is then passed to the <Transform> command 
which subsequently applies an Extensible Stylesheet Language Transformation 
(XSLT) to produce a desired entity. 

[0026] The following code illustrates an exemplary definition file, in accordance 
with the embodiment described above. 

Code Sample 1. Definition File 

1 <?xral version="l. 0" encoding="UTF~8"?> 

2 <Def initionFile> 

3 <Name>SessionEJBGenerator</Name> 

4 <General> 

5 <Version>l . 0</Version> 

6 <ShortDescrpt> Generates EJBs </ShortDescrpt> 

7 <LongDescrpt>Collects the data to generate EJBs</LongDescrpt> 

8 </General> 

9 <Source> 

10 <JavaPackage>cotn. sun. forte4 j . session</JavaPackage> 
11 

12 <Directory>gen</Di rectory > 

13 <SchemaFile>session.xsd</SchemaFile> 

14 <AnnotationsFile/> 

15 <PropertyFile>Bundle .properties</PropertyFile> 
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16 <ResourceFile>bean.xsl</ResourceFile> 

17 <ResourceFile>home . xsl</ResourceFile> 

18 <ResourceFile> remote . xsl</ResourceFile> 
• 19 <ResourceFile>sesejb.xsl</ResourceFile> 

20 <ResourceFile>ejbdd.xsl</ResourceFile> 

21 </Source> 

22 <Metadata> 

23 <Extension>ses</Extension> 

24 <Default> 

25 <ResourceFile>SessionEJBGenerator . ses</ResourceFile> 

26 </Default> 

27 <RootElement>Session</RootElement> 

28 <ReplacementRootElement>/</ReplacementRootElement> 
2 9 </Metadata> 

30 <UserInterf ace> 

31 <DisplayName>Session EJB Generation Module</DisplayName> 
Q 32 <Description>Creates Session EJBs</Description> 

P 33 <Category>J2EE Tools</Category> 

£.| 34 <ExplorerNode> 

35 <Icon> 

36 <ResourceFile>SessionEJBDataIcon.gif </ResourceFile> 

37 </Icon> 

38 <ContextMenu> 

39 <Action> 

40 <NaTne> Gene rat e< /Name > 

1^ 41 <LabelKey>LBL_Action_Generate</liabelKey> 

S5|5 42 <Shortcut/> 

43 </Action> 
1"^^ 44 <Separator/> 

45 <Folder> 
£3 46 <Name>Tools</Name> 

M» 4 7 <Action> 

4 8 <Name >Bui ld< /Name > 

49 <LabelKey> LBL_Ac t i on_Bu ild</LabelKey> 

50 <Shortcut/> 

51 </Action> 

52 <Separator/> 

53 </Folder> 

54 </ContextMenu> 

55 </ExplorerNode> 

56 <Toolbar> 

57 < Name >Bu i 1 d< /Name > 

58 <Action> 

59 <Name>Generate</Name> 

60 <LabelKey>LBL_Action_Generate</LabelKey> 

61 <Icon> 

62 <ResourceFile>SessionEJBDataIcon.gif </ResourceFile> 

63 </Icon> 

64 </Action> 

65 <Separator/> 

66 <Action> 

67 <Name>Build</Name> 

68 <LabelKey>LBL_Action__Build</LabelKey> 

69 </Action> 

70 </Toolbar> 
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71 <Menu> 

72 <Name >Tools</Name > 

73 <Action> 

74 <Name>Generate</Name> 

75 <LabelKey>LBL_Action__Generate</LabelKey> 

76 <Shortcut>'^G</Shortcut> 

77 </Action> 

78 <Folder> 

79 <Name>ISV Tools</Name> 

80 <Action> 

81 <Name>Generate</Narae> 

82 < Label Key >LBL_Action_Generate</LabelKey> 

83 < Shortcut >^G</ Shortcut > 

84 </Action> 

85 </Folder> 

86 </Menu> 

h'^ 87 </UserInterf ace> 

Q 8 8 <Runtime> 

89 <Logger> 

?75 90 <MessagePref ix>SessionEJB: </MessagePref ix> 

^ 91 <Def aultSetting>* : *</Def aultSetting> 

92 < /Logger > 

^"1 93 <Classpath/> 

W 94 <DependentModules/> 
m 95 < /Runtime> 
g 96 <ActionDef inition> 

97 <Narae>Generate</Name> 

Jjl 99 < Commandx Trans form> 

ny 100 <Transf ormFile><Name>sesejb . xsl</Name></Transf ormFile> 

•r=^ 101 <OutputFile><Name><xsl : value-of select^ " translate 

0 102 (Session/Package,'.', '/ M '7>/<xsl : value-of 

L^i 103 select="Session/EjbName"/> . sesejb</Name></OutputFile> 

104 </ Trans formx /Command > 

105 

106 <Comraand><Transf orm> 

107 <Transf ormFile><Name>e jbdd.xsl< /Name >< /Trans formFile> 

108 <OutputFile><Name><xsl : value-of selects" translate 

109 (Session/Package,',', '/')" />/<xsl : value-of 

110 select="Session/EjbName"/> • ejbdd</Name></OutputFile> 

111 </Transf orm></Command> 
112 

113 <Command><Transf orm> 

114 <Transf ormFile><Name>bean.xsl</Name></Transf ormFile> 

115 <OutputFile><Name><xsl : value-of select= " translate 

116 (Session/Package,'.', V ) "/>/<xsl : value-of 

117 select="Session/EjbName"/>EJB . j ava</Name></OutputFile> 

118 < /Trans formx /Command > 
119 

120 <Coramand><Transf orm> 

121 <Transf ormFile><Name>home .xsl</Name></Transf ormFile> 

122 <OutputFilexName><xsl : value-of select= "translate 

123 (Session/Package,'.', '/') "/>/<xsl : value-of 

124 select="Session/EjbName"/>Home . java</Name></OutputFile> 

125 </Transform></Command> 
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126 

127 < Commandx Trans form> 

128 <Transf ormFile><Nanie>remote .xsl</Narae></Transf ormFile> 

129 <OutputFile><Name><xsl :value-of select="translate (Session/Package, 

130 ' /' ) '7>/<xsl :value-of 

131 select="Session/EjbName"/> . j ava</Name></OutputFile> 

132 < /Trans form></Command> 
133 

134 </ActionDef inition> 

135 </Def initionFile> 



[0027] In the code listed above referred to as ''Code Sample 1", lines 4-8 define the 
properties of the <General> element. For example, the short description denoted 
as <ShortDescrpt> provides the following short description 'Generates EJBs". 
Lines 9-21 define the properties of the <Soiirce> element. In this particular 
example, the <Source> element lists a <SchemaFile> as session.xsd. Further, the 
<Source> element lists five <ResourceFiles>: beans.xsl, home.xsl, remote.xsl, 
sesjb.xsl, and ejbdd.xsl. Lines 22-29 define the properties of the <Metadata> 
element. For example, the file containing the default metadata values is 
SessionEJBGenerator.ses. Lines 30 - 87 define properties of the <UserInterface 
Element>. For example, the <UserInterface> element specifies that the action 
"Generate" is located in the "tool" menu and have a short cut of ""^G." Lines 96- 
124 define the properties of the <ActionDefinition> element. In this example, 
there is only one action "Generate" that is defined as a series of transform 
conomands. For example, the first <transform> command takes in the sesejb.xsl 
document as input and generates a .sesejb file as output, 

[0028] Referring back to Figure 2, the schema (28) defines the data to be collected 
from the user of the SDT (34) at runtime. Consider the following exemplary 
schema referenced by the definition file above. 

Code Sample 2. Schema.xsd 

1 <?xml version="l . 0" encoding="UTF-8 " ?> 

2 <xsd:schema xmlns : xsd="http : //www . w3 . org/2 0 01/XMLSchema" 



3 targetNamespace= "http ; //ejb . f orte4 j . sun . com" 

4 xmlns="http : //ejb. f orte4 j . sun. com" 

5 elementFormDefault=" qualified" > 

6 <xsd; element name= "Sess ion " > 
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7 <xsd: coraplexType> 

8 <xsd: sequence> 

9 <xsd: element name= "EjbName" type="xsd: string" /> 

10 <xsd;element name = "Package " type="xsd: string'7> 

11 <xsd: element name="SessionType" > 

12 <xsd: simpleType> 

13 <xsd:restriction base= "xsd : string" > 

14 <xsd: enumeration value= " Statef ul " / > 

15 <xsd : enumeration value= "Stateless"/> 

16 </xsd: restriction> 

17 </xsd: simpleType> 

18 </xsd: element > 

19 <xsd: element name="TransactionType" > 

20 <xsd: simpleType> 

21 <xsd: restriction base="xsd: string" > 

22 <xsd: enumeration value="Container" /> 

23 <xsd: enumeration value= "Bean" /> 
p 24 </xsd:restriction> 

Q 25 </xsd: sirapleType> 

|j:f 26 < /xsd : element > 

^ 27 <xsd:element name= "TransactionAttribute" > 

28 <xsd: simpleType> 

29 <xsd: restriction base= "xsd : string" > 

W 30 <xsd: enumeration value= "Mandatory" /> 

31 <xsd: enumeration value= "Never" /> 

3 32 <xsd: enumeration value= "NotSupported" / > 

y. 33 <xsd: enumeration value= "Required" /> 

^■3 34 <xsd: enumeration value="RequiresNew"/> 

LJh 35 <xsd: enumeration value= "Supports"/> 

J-f 36 </xsd: restriction> 

37 </xsd: simpleType> 

3 8 </xsd: element > 
39 </xsd: sequence> 

4 0 </xsd: complexType> 

41 </xsd : element> 

42 </xsd: schema> 

[0029] Referring to the schema above referred to as "Code Sample 2'\ line 9 
defines a first required input "EjbName" and indicates that "EjbName" must be of 
type string. Line 10 defines a second required input "Package" and indicates that 
"Package" must also be of type string. Lines 11-17 define a third required input 
"SessionType." Unlike the first and the second required input, the third required 
input may only have one of two possible values: "Statefiil" or "Stateless." 
Similarly, lines 19-26 define a fourth required input "TransactionType" which 
may only have one of two possible values: "Container" or "Bean." Lines 27-38 
define a fifth and final required input "TransactionAttribute." The 
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"TransactionAttribute" may have one of six possible values: "Mandatory", 
"Never", "NotSupported", Required", "RequiresNew", and "Supports." In one 
embodiment of the present invention, the schema (28) is represented as an XML 
document. 

[0030] Referring back to Figure 2, the resource file (30) contains data required by 
the SDT (34) at runtime. The resources files typically define how the data, input 
by the user of the SDT (34), is to be processed to produce the desired entity, e.g., 
an EJB. In one embodiment of the invention, the resource file (30) is an 
Extensible Stylesheet Language (XSL) document. In the particular case of an 
XSL document, the document defines transformations of the metadata stored in an 
XML format. Resource files (30) typically reference variables within the metadata 
using descriptors defined in the schema (28). 

[0031] The following code illustrates a resource file (30) referenced by the 
definition file above. 

Code Sample 3. Bcan.xsl 

1 <?xml version="l . 0"?> 



2 <xsi : transform xmins : xsi=http://www.w3.org/1999/XSL/Transform 

3 version="l . 0 " > 

4 <xsl:output method="xml" indent= "yes" /> 

5 <xsl: strip-space elements="*"/> 
5 



6 <xsl: template match="Session" > 
7 

8 <ejb-jar> 



9 <enterprise-beans> 

10 <session> 

11 <description><xsl ;value-of select="EjbName"/> Session 

12 Bean</description> 

13 <display-name><xsl:value-of select= "E jbName " /></display-name> 

14 <ejb-narae><xsl :value-of select^ "E jbNarae" /></e jb-name> 

15 <horae><xsl : value - of select= " Package "/ > . <xsl : value -of 

16 select = "Ej bName " / >Home < / home > 

17 <remote><xsl: value- of select=" Package" /> - <xsl :value-of 

18 select="EjbName"/></remote> 

19 <ejb-class><xsl:value-of select=" Package"/ >• <xsl :value-of 

20 select="EjbName"/>EJB</ejb-class> 

21 <session-type><xsl:value-of select="SessionType" /></session-type> 

22 <transaction- typexxsl : value-of 

23 select="TransactionType"/></ transaction- type> 
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24 </session> 

25 </enterprise-beans> 
26 

27 <asseTnbly-descriptor> 

28 <container-transaction> 

29 <method> 

30 <ejb-natne><xsl :value-of select="EjbName"/></e jb-name> 

3 1 <method-name > * < /me t hod -name > 

32 </method> 

33 <trans-attribute><xsl : value-of 

34 select="TransactionAttribute"/></trans- attribute > 
3 5 < /container- transact ion> 

3 6 </assembly-descriptor> 



37 </ejb- jar> 

38 

39 </xsl : template> 

4 0 < /xsl : transf orm> 

[0032] The resource file listed above, referred to as "Code Sample 3", contains 
definitions for processing data received from the user of the SDT (34) and 
generating a portion of a desired entity. Specifically, in the resource file listed 
above, line 13 indicates that the display name for the EJB being generated should 
have the value of the "EjbName" input. Further, line 15 indicates that the home 
interface, denoted as <home>, should have the value of the "Package" input. 
Further, line 21 indicates that the session-type should have the value of the 
"SessionType" input. Further, line 23 indicates that the transaction-type should 
have the value of the "TransactionType" input. Fmally, line 33 indicates that the 
trans-attribute should have the value of the "TransactionAttribute" input. 

[0033] Referring to Figure 2, the command list (32) defines a set commands that 
may be used in the definition file (26) to defme the actions. In one embodiment of 
the invention, the command list (32) is provided to the SDTG (24) as an input. In 
another embodiment of the invention, the command list is coded into the SDTG 
(24). When the SDT (34) is generated by the SDTG (24), the SDT (34) contains 
the required functionality to interpret commands used within the 
<ActionDefinition>. 
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[0034] In one embodiment, each command within the command list (32) is defined 
with a required input and output. Further, the ftmctionaUty to process each 
command is also specified. For example, the <Transform> command used in the 
definition file (refer to Code Sample 1, lines 96 - 134), listed above, uses a 
<TransformFile> parameter as input and an <Output> parameter to specify the 
location of the output of the command. In one embodiment of the invention, the 
<Transform> command initiates a Xalan^" Extensible Stylesheet Language 
Transformations (XSLT) processor that performs the transformations, specified in 
the <TransformFile>, upon the metadata collected fi-om the user. 

[0035] While only one specific command has been detailed, those skilled in the art 
will appreciate that other commands may be incorporated into the SDT (34). For 
example, the SDT (34) may contain fimctionality to execute an Ant script, copy 
and delete data, execute an external executable, invoke another action, execute a 
Java™ method, raise a dialogue to a user, etc. 

[0036] In one embodiment of the invention, the SDTG (24) is a Java™ component 
that is run in a stand alone runtime environment. 

[0037] In another embodiment of the present invention, the SDTG (24) is a module 
with an Integrated Development Environment (IDE), such as Forte™ for Java^". 
Figure 3 illustrates a software development tool generator integrated within an 
Integrated Development Environment in accordance with one embodiment of the 
invention. In this particular example, the SDTG (24) is generating a 
"sessionEJBGenerator" tool and has been integrated into the File System (38). 
Additionally, the functionality of the SDTG (34) is included in tiie menu (40). 
Specifically, in this example, the menu option to generate the tool is "build me a 
tool" (42). 

[0038] Once the SDT (34) has been generated, the user of the SDTG (34) may 
modify the source code or the annotations document prior to deploying the tool to 

15 



PATENT APPLICATION 
ATTORNEY DOCKET NO. 16159/039001; P7221 



an end user. This provides the user a means to customize the user interface of the 
tool by modifying the annotations, and a means to optimize the tool for a given 
platform or change its executable behavior by modifying the source code. 

[0039] As shown in Figure 2, the SDTG (24) generates a SDT (24) and 
Annotations (36). Annotations define how the information specified in the schema 
(28) is obtained from the user, Le,, the layout of the user interface to the tool, etc. 
In one embodiment of the invention, the annotations (36) are stored as an XML 
document. Further, the decisions regarding the means for obtaining information 
from the user, e.g., to use a text box versus a drop-down menu to obtain a 
particular piece of information, is typically coded into the annotations (36) by the 
SDTG (24). The following code illustrates exemplary annotations corresponding 
to the schema listed above (refer to Code Sample 2). 



Code Sample 4. Annotations. xml 

1 <?xml version="1.0" encoding="UTF-8 " ?> 

2 <ToolUI xmlns:xsd=http://www.w3 .org/2001/XMLSchema 

3 name= "SessionEJBGenerator" > 



4 <Wizard name="SessionEJBGeneratorWizard" xmlbean="Session" label="New 

5 Session" > 

6 <PanelRef ref = " targetChooser" built - in= " target " label = "Choose 

7 Name"/> 

8 <PanelRef ref ="SessionPanel " source="." mult iplicity= "One " 

9 xmlbean="Session" label="Specify Session Properties" /> 

10 </Wizard> 

11 <Panel name="SessionPanel " xmlbean="Session" multiplicity= "One" 

12 label= "Session Properties" > 

13 <TextField name= "E jbNameField" source= "E jbName " label= "E jbName " /> 

14 <TextField name= " PackageField" source= " Package " labels " Package " /> 

15 <RadioPanel source="SessionType" label="SessionType" > 

16 <Choice value="Stateful" label="Stateful"/> 

17 <Choice value= " Stateless " label="Stateless"/> 

18 </RadioPanel> 

19 <RadioPanel source=" Transact ionType" label= " Transact ionType " > 
2 0 <Choice value=" Container" label= "Container "/> 

21 <Choice value="Bean" label="Bean"/> 

22 </RadioPanel> 

23 <CoraboBox source= "Transact ionAttribute" 

24 label= "Transact ionAttribute " > 

25 <Choice value== "Mandatory " label= "Mandatory" /> 

26 <Choice value="Never " label="Never " /> 

27 <Choice value= "NotSupported" label= "NotSupported" /> 

28 <Choice value="Required" label="Required" /> 

29 <Choice value- "RequiresNew" label="RequiresNew"/> 
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30 <Choice value=" Supports" label="Supports"/> 

31 </CoraboBox> 

32 </Panel> 

33 </ToolUI> 

[0040] In the annotations document listed above referred to as "Code Sample 4", 
lines 4-10 indicate that a wizard is used to obtain data from the user. Specifically, 
there are two panels: a "Choose Name" panel and a "Specify Session Properties" 
panel. Lines 11-31 detail how the various session property values are t obtained 
from the user. For example, line 13 indicated that the "EjbName" property is 
obtained using a TextField. Additionally, lines 15-18 indicate that the 
"SessionType" property is obtained using a RadioPanel. Further, lines 23 -31 
indicate that the "TransactionAttribute" property is to be obtained using a 
ComboBox. 

[0041] In one embodiment of the invention, the SDT (34) is a Java™ component 
that is run in a stand alone runtime environment. 

[0042] In another embodiment of the present invention, the SDT (34) is module 
with an Integrated Development Environment (IDE) such as Forte™ for Java™. In 
this particular example, the SDTG (24) has generated a tool to create EJBs using 
the "build me a tool command" (44 in Figure 3). The user of the SDT (34) 
subsequently uses SDT (34) to generate an EJB. 

[0043] Figures 4 and 5 illustrate the wizard used to collect data to generate a 
desired EJB. Figure 4 illusfrates a "Choose Name" panel that is referenced above 
in the annotations document. The "Choose Name" panel (46) includes a textbox 
(48) to enter the name of the EJB to be generated. Further, the "Choose Name" 
panel contains a number of buttons for navigation (50). 

[0044] Figure 5 illustrates a "Specify Session Property" panel (52) that is 
referenced in the above annotations document. The "Specify Session Property" 
panel (52) includes a textbox (54) to enter the "EjbName", a textbox (56) to enter 
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the "Package", a radio button panel (58) to specify the "SessionType", a radio 
button panel (60) to specify the "TransactionType", a combo box (62) to specify 
the "TransactionAttribute", and a number of buttons for navigation (50). Once the 
user clicks the "Finish Button" (64). The information collected by the wizard 
from the end user is typically stored as metadata. 

[0045] The end user may subsequently apply an action or multiple actions to the 
metadata using actions defined in the <ActionDefinition>. Figure 6 illustrates a 
software development tool integrated within an Integrated Development 
Environment, in accordance with one embodiment of the invention. In this 
particular example, the EJB generator tool only has one action, "Generate EJB" 
(66), that is accessible via a pop-up menu (60). Once the user selects the 
"Generate EJB" action, the EJB generator tool applies the conamands listed within 
the action to generate the desired entity. 

[0046] The invention has one or more of the following advantages. The present 
invention allows new software development tools to be generated and deployed in 
a shorter time span. Further, the present invention allows software development 
companies to readily develop internal tools customized to their specific 
requirements. Further, the present invention allows a user to create a series of 
tools which are consistent across a given environment. Further, the present 
invention allows graphical user interfaces to be created ft-om the schema without 
the need to write additional source code. Further, the present invention allows the 
definition of semantics of a software development tool to be done through a 
schema and definition file without the need to write additional source code. 

[0047] While the invention has been described with respect to a limited number of 
embodiments, those skilled in the art, having benefit of this disclosure, will 
appreciate that other embodiments can be devised which do not depart from the 
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scope of the invention as disclosed herein. Accordingly, the scope of the 
invention should be limited only by the attached claims. 
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